Visual Studio 15 2017

在 3.7.1 版本中添加。

可生成 Visual Studio 15 (VS 2017) 项目文件。

项目类型

只能生成 Visual C++ 和 C# 项目(以及与英特尔编译器集成的 Fortran)。不支持其他类型的项目(JavaScript、Powershell、Python 等)。

实例选择

在 3.11 版本中添加。

VS 2017 支持在同一台计算机上进行多重安装。CMAKE_GENERATOR_INSTANCE 变量可用于选择某个安装。

平台选择

默认目标平台名称(体系结构)为 Win32

CMAKE_GENERATOR_PLATFORM 变量可通过 cmake -A 选项进行设置,以指定目标平台名称(体系结构)。例如

  • cmake -G "Visual Studio 15 2017" -A Win32

  • cmake -G "Visual Studio 15 2017" -A x64

  • cmake -G "Visual Studio 15 2017" -A ARM

  • cmake -G "Visual Studio 15 2017" -A ARM64

为了与 3.1 之前的 CMake 版本兼容,可在生成器名称的末尾处选择性地指定目标平台名称。这只适用于

Visual Studio 15 2017 Win64

指定目标平台 x64

Visual Studio 15 2017 ARM

指定目标平台 ARM

工具集选择

默认情况下选择 Visual Studio 15 2017 附带的 v141 工具集。CMAKE_GENERATOR_TOOLSET 选项可通过 cmake -T 选项进行设置,以指定另一个工具集。

从版本 3.8 起新增: 对于此版本的 Visual Studio 随附的每个工具集,都存在针对 32 位 (x86) 和 64 位 (x64) 主机(独立于它们的目标体系结构)进行编译的变体。默认情况下,此生成器即使在 64 位主机上也使用 32 位变体。可以通过向工具集规范添加 host=x86host=x64 来明确请求使用 32 位或 64 位主机工具。有关详细信息,请参阅 CMAKE_GENERATOR_TOOLSET 变量。

从版本 3.14 起新增: 新增了对 host=x86 选项的支持。